<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="keywords" content="pkgdiff, rpm, deb, diff, changes" />
  <meta name="description" content="A tool for visualizing changes in Linux software packages" />
  <title>pkgdiff - Package Changes Analyzer</title>

  <style type="text/css">
    body {
      margin-top: 1.0em;
      background-color: #deeef7;
      font-family: Helvetica, Arial, FreeSans, san-serif;
      color: #000000;
    }
    #container {
      margin: 0 auto;
      width: 700px;
    }
    h1 { font-size: 3.8em; color: #211108; margin-bottom: 3px;margin-top:0px;padding-top:0px;}
    h1 .small { font-size: 0.4em; }
    h1 a { text-decoration: none }
    h2 { font-size: 1.5em; color: #211108; }
    h3 { text-align: center; color: #211108; }
    a { color: #211108; }
    .description { font-size: 1.2em; margin-bottom: 30px; margin-top: 30px; font-style: italic;}
    .download { float: right; }
    pre { background: #000; color: #fff; padding: 15px;}
    hr { border: 0; width: 80%; border-bottom: 1px solid #aaa}
    .footer { text-align:center; padding-top:30px; font-style: italic; }
  </style>

<script type="text/javascript">

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-19501755-2']);
  _gaq.push(['_trackPageview']);

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

</script>

</head>

<body>
  <a href="https://github.com/lvc/pkgdiff"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a>

  <div id="container">

    <div class="download">
      <a href="https://github.com/lvc/pkgdiff/zipball/master">
        <img style="border: 0;" width="90" src="https://github.com/images/modules/download/zip.png" alt="" /></a>
      <a href="https://github.com/lvc/pkgdiff/tarball/master">
        <img style="border: 0;" width="90" src="https://github.com/images/modules/download/tar.png" alt="" /></a>
    </div>
   
    <h1><a href="https://github.com/lvc/pkgdiff">pkgdiff</a></h1>

    <div class="description">
      A tool for visualizing changes in Linux software packages
    </div>

    
      <p>Package Changes Analyzer (pkgdiff) is a tool for visualizing changes in Linux software packages (RPM, DEB, TAR.GZ, etc). The tool is intended for Linux maintainers who are interested in ensuring compatibility of old and new versions of packages.</p>
      
      <p/>
      The tool is developed by Andrey Ponomarenko: <a href='https://abi-laboratory.pro/'>https://abi-laboratory.pro/</a>

<table style='border:1px solid grey;'><tr><td>
<div>Table of Contents</div>
<ul>
<li><a href="#Downloads" rel="nofollow">Downloads</a></li>
<li><a href="#License" rel="nofollow">License</a></li>
<li><a href="#Supported_Platforms" rel="nofollow">Supported Platforms</a></li>
<li><a href="#Dependencies" rel="nofollow">Dependencies</a></li>
<li><a href="#Installation" rel="nofollow">Installation</a></li>
<li><a href="#Usage" rel="nofollow">Usage</a></li>
<li><a href="#Examples" rel="nofollow">Examples</a></li>
<li><a href="#Adv_Usage" rel="nofollow">Adv. Usage</a></li>
<li><a href="#Adv_Examples" rel="nofollow">Adv. Examples</a></li>
<li><a href="#Bugs" rel="nofollow">Bugs</a></li>
<li><a href="#Maintainers" rel="nofollow">Maintainers</a></li>
<li><a href="#ChangeLog" rel="nofollow">Changes</a></li>
</ul>
</td></tr></table>

<a name="Downloads"></a>
<h2>Downloads</h2>
<p>All releases can be downloaded from <a href="https://github.com/lvc/pkgdiff/releases">this page</a>.</p>

<p>Latest release: <a href="https://github.com/lvc/pkgdiff/archive/1.7.2.tar.gz">pkgdiff-1.7.2.tar.gz</a></p>

<p>Read-only access to the latest development version:</p>

<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;git clone git://github.com/lvc/pkgdiff&nbsp;</code>

<a name="License"></a>
<h2>License</h2>
<p>This program is free software. You may use, redistribute and/or modify it under the terms of the <a href="http://www.gnu.org/licenses/" rel="nofollow">GNU GPL</a></p>

<a name="Supported_Platforms"></a>
<h2>Supported Platforms</h2>
GNU/Linux, FreeBSD, Mac OS X
    
<a name="Dependencies"></a>
<h2>Dependencies</h2>
Requires:
<ul>
<li>
  <a href="http://www.perl.org/" rel="nofollow">Perl 5</a> (5.8 or newer)
</li>
<li>
  <a href="http://www.gnu.org/software/diffutils/" rel="nofollow">GNU Diff</a>
</li>
<li>
  <a href="http://www.gnu.org/software/wdiff/" rel="nofollow">GNU Wdiff</a>
</li>
<li>
  <a href="http://www.gnu.org/software/gawk/" rel="nofollow">GNU Awk</a>
</li>
<li>
  <a href="http://www.gnu.org/software/binutils/" rel="nofollow">GNU Binutils</a> (readelf)
</li>
<li>
  <a href="http://rpm.org/" rel="nofollow">RPM</a> (rpm2cpio, rpm) for analysis of RPM packages
</li>
<li>
  <a href="http://packages.debian.org/squeeze/dpkg" rel="nofollow">DPKG</a> (dpkg-deb, dpkg) for analysis of DEB packages
</li>
</ul>

Suggests:
<ul>
<li>
  <a href="https://github.com/lvc/abi-compliance-checker/">ABI Compliance Checker</a> (1.99.1 or newer)
</li>
<li>
  <a href="https://github.com/lvc/abi-dumper/">ABI Dumper</a> (0.97 or newer)
</li>
</ul>
    
<a name="Installation"></a>
<h2>Installation</h2>
<p>The tool is <b>ready-to-use</b> after extracting the archive.</p>

<p>You can also use a <b>Makefile</b> to install the tool into the system:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;sudo make install prefix=PREFIX [/usr, /usr/local]&nbsp;</code>
<p>This command will install a  <code>pkgdiff</code>  program to the <code>PREFIX/bin</code> system directory and private modules into the <code>PREFIX/share</code>.</p>

<a name="Usage"></a>
<h2>Usage</h2>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff PKG1 PKG2&nbsp;</code>
<p>The HTML report will be generated to:</p>

<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/&lt;pkg&gt;/&lt;v1&gt;_to_&lt;v2&gt;/changes_report.html&nbsp;</code>

<a name="Examples"></a>
<h2>Examples</h2>
<p>Compare 0.4.1 and 0.8.1 versions of libqb SRPM-packages:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff libqb-0.4.1-2.fc15.src.rpm libqb-0.8.1-2.fc16.src.rpm&nbsp;</code>
<p>The HTML report will be generated to:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/libqb/0.4.1_to_0.8.1/<a style='color:Blue;' href="http://lvc.github.com/pkgdiff/pkgdiff_reports/libqb/0.4.1_to_0.8.1/changes_report.html">changes_report.html</a>&nbsp;</code>

<br/><br/>
<p>Compare 0.10.23 and 0.10.32 versions of gstreamer TXZ-packages:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff gstreamer-0.10.23-i486-1.txz gstreamer-0.10.32-i486-1.txz&nbsp;</code>
<p>The HTML report will be generated to:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/gstreamer/0.10.23-i486-1_to_0.10.32-i486-1/<a style='color:Blue;' href="http://lvc.github.com/pkgdiff/pkgdiff_reports/gstreamer/0.10.23-i486-1_to_0.10.32-i486-1/changes_report.html">changes_report.html</a>&nbsp;</code>

<br/><br/>
<p>Compare 0.3.4 and 0.4.0 versions of libssh TAR.GZ-packages:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff libssh-0.3.4.tar.gz libssh-0.4.0.tar.gz&nbsp;</code>
<p>The HTML report will be generated to:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/libssh/0.3.4_to_0.4.0/<a style='color:Blue;' href="http://lvc.github.com/pkgdiff/pkgdiff_reports/libssh/0.3.4_to_0.4.0/changes_report.html">changes_report.html</a>&nbsp;</code>

<br/><br/>
<p>Compare 1.10.2 and 1.12.2 versions of cairo DEB-packages:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff libcairo2-dev_1.10.2-6.1_i386.deb libcairo2-dev_1.12.2-1_i386.deb&nbsp;</code>
<p>The HTML report will be generated to:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/libcairo2-dev/1.10.2-6.1_to_1.12.2-1/<a style='color:Blue;' href="http://lvc.github.com/pkgdiff/pkgdiff_reports/libcairo2-dev/1.10.2-6.1_to_1.12.2-1/changes_report.html">changes_report.html</a>&nbsp;</code>

<br/><br/>
<p>Compare 2.24.1 and 2.28.8 versions of glib RPM-packages:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff libglib2.0-devel-2.24.1.i586.rpm libglib2.0-devel-2.28.8.i586.rpm&nbsp;</code>
<p>The HTML report will be generated to:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/libglib2.0-devel/2.24.1_to_2.28.8/<a style='color:Blue;' href="http://lvc.github.com/pkgdiff/pkgdiff_reports/libglib2.0-devel/2.24.1_to_2.28.8/changes_report.html">changes_report.html</a>&nbsp;</code>

<a name="Adv_Usage"></a>
<h2>Adv. Usage</h2>
<p>For advanced usage, see output of --help option:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff --help&nbsp;</code>
<p>If you need to analyze a group of packages then you can create an XML-descriptor of this group (OLD.xml file):</p>

<div style='padding-left:20px;border:1px solid black;width:70%;'>
  &lt;version&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;2.24.1<br/>
  &lt;/version&gt;<br/><br/>

  &lt;group&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libglib<br/>
  &lt;/group&gt;<br/><br/>

  &lt;packages&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libglib2.0-devel-2.24.1-1mdv2010.1.i586.rpm<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libglib2.0_0-2.24.1-1mdv2010.1.i586.rpm<br/>
  &lt;/packages&gt;<br/>
</div>

<p>And then pass XML-descriptors of old and new versions of a group to the tool:</p>

<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff OLD.xml NEW.xml&nbsp;</code>

<p>The HTML report will be generated to:</p>

<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/&lt;group&gt;/&lt;v1&gt;_to_&lt;v2&gt;/changes_report.html&nbsp;</code>

<a name="Adv_Examples"></a>
<h2>Adv. Examples</h2>
<p>Compare 2.3.12 and 2.4.5 versions of libfreetype6 group of RPM-packages:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff 2.3.12.xml 2.4.5.xml&nbsp;</code>

<p>File 2.3.12.xml:</p>
<div style='padding-left:20px;border:1px solid black;width:70%;'>
  &lt;version&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;2.3.12<br/>
  &lt;/version&gt;<br/><br/>

  &lt;group&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libfreetype6<br/>
  &lt;/group&gt;<br/><br/>

  &lt;packages&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libfreetype6-2.3.12-1mdv2010.1.i586.rpm<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libfreetype6-devel-2.3.12-1mdv2010.1.i586.rpm<br/>
  &lt;/packages&gt;<br/>
</div>

<p>File 2.4.5.xml:</p>
<div style='padding-left:20px;border:1px solid black;width:70%;'>
  &lt;version&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;2.4.5<br/>
  &lt;/version&gt;<br/><br/>

  &lt;group&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libfreetype6<br/>
  &lt;/group&gt;<br/><br/>

  &lt;packages&gt;<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libfreetype6-2.4.5-2-mdv2011.0.i586.rpm<br/>
      &nbsp;&nbsp;&nbsp;&nbsp;libfreetype6-devel-2.4.5-2-mdv2011.0.i586.rpm<br/>
  &lt;/packages&gt;<br/>
</div>

<p>The HTML report will be generated to:</p>
<code style="border: dashed 1px gray; background-color: #f0f0f0;">&nbsp;pkgdiff_reports/libfreetype6/2.3.12_to_2.4.5/<a style='color:Blue;' href="http://lvc.github.com/pkgdiff/pkgdiff_reports/libfreetype6/2.3.12_to_2.4.5/changes_report.html">changes_report.html</a>&nbsp;</code>

<a name="Bugs"></a>
<h2>Bugs</h2>
<p>Please post your bug reports, feature requests and questions to the <a href="https://github.com/lvc/pkgdiff/issues" rel="nofollow">issue tracker</a>.</p>

<a name="Maintainers"></a>
<h2>Maintainers</h2>
The tool is developed by <a href="https://abi-laboratory.pro/" rel="nofollow">Andrey Ponomarenko</a>.

<a name="ChangeLog"></a>
<h2>Changes</h2>

<b>Version 1.8 (January 28, 2017)</b><br/>
<b>Bug Fixes</b>
<ul>
    <li>
        Fixed -d option to compare large directories
    </li>
    <li>
        Added more file classes
    </li>
    <li>
        5% performance improvement
    </li>
    <li>
        Omit *.N suffix when determining the file format
    </li>
    <li>
        Do not print warning about missed wdiff into the report
    </li>
    <li>
        Increased default width of the report to 80 chars
    </li>
</ul>
<br/>

<b>Version 1.7.2 (March 18, 2016)</b><br/>
<b>New Features</b>
<ul>
    <li>
        Ability to download plain-text added/removed patches from the report
    </li>
</ul>
<b>Bug Fixes</b>
<ul>
    <li>
        Do not show time stamp in the report
    </li>
    <li>
        Fixed removal of tmp directory in the rfcdiff-1.41-CUSTOM.sh
    </li>
</ul>
<br/>

<b>Version 1.7.1 (December 11, 2015)</b><br/>
<b>New Features</b>
<ul>
    <li>
        Added -skip-pattern option: skip checking of paths within archives matching a regex
    </li>
</ul>
<b>Bug Fixes</b>
<ul>
    <li>
        Fixed incompatibility with the latest versions of the ABICC tool
    </li>
    <li>
        Fixed comparison of the RPM/Deb packages info
    </li>
</ul>
<br/>

<b>Version 1.7.0 (October 18, 2015)</b><br/>
<b>New Features</b>
<ul>
    <li>
        Added -d option: compare directories instead of packages
    </li>
    <li>
        Added -list-added-removed option: show content of added/removed text files
    </li>
    <li>
        Added -vnum1 and -vnum2 options: set version numbers of input packages
    </li>
    <li>
        Added -title option: set name of the package in the title of the report
    </li>
    <li>
        Added -skip-subarchives option: skip checking of archives inside packages
    </li>
</ul>
<br/>

<b>Version 1.6.4 (September 08, 2015)</b><br/>
<b>Bug Fixes</b>
<ul>
    <li>
        Fixed style of the report
    </li>
    <li>
        Fixed install permissions
    </li>
    <li>
        Fixed errors when comparing man pages
    </li>
    <li>
        Added check for wdiff
    </li>
    <li>
        Simplified Makefile
    </li>
</ul>

<br/>

<b>Version 1.6.3 (November 05, 2014)</b><br/>
<b>New Features</b>
<ul>
    <li>
        Added -hide-unchanged option: don't show unchanged files in the report
    </li>
    <li>
        Show change rate in the extra info files.xml (moved, changed, renamed)
    </li>
    <li>
        Check if we can remove a common prefix from files of both packages
    </li>
    <li>
        Encoding of diff reports has been changed to utf-8
    </li>
</ul>
<b>Bug Fixes</b>
<ul>
    <li>
        Fixed a problem with spaces in package name
    </li>
    <li>
        Added -o option to unzip command
    </li>
    <li>
        Fixed -tmp-dir option
    </li>
</ul>

<br/>

<b>Version 1.6 (June 07, 2013)</b><br/>
<b>New Features</b>
<ul>
    <li>
        ABI compatibility check for shared objects and kernel modules containing DWARF debugging information (in <i>-details</i> mode)
    </li>
    <li>
        ABI status section in the report for debuginfo-packages
    </li>
    <li>
        Suggests ABI Compliance Checker 1.99.1
    </li>
    <li>
        Suggests ABI Dumper 0.97
    </li>
</ul>

<br/>

<b>Version 1.5 (April 04, 2013)</b><br/>
<b>New Features</b>
<ul>
    <li>
        Added -extra-info option to dump extra analysis information
    </li>
    <li>
        Improved identification of moved files
    </li>
    <li>
        Classifying files by magic bytes
    </li>
    <li>
        Compare public symbols in shared objects before detailed comparison
    </li>
    <li>
        Added statistics comment line in the report
    </li>
    <li>
        Support for more file types
    </li>
</ul>
<b>Bug Fixes</b>
<ul>
    <li>
        Corrected Makefile
    </li>
    <li>
        Corrected parser of package version
    </li>
</ul>

<br/>

<b>Version 1.4.1 (December 14, 2012)</b><br/>
<b>Bug Fixes</b>
<ul>
    <li>
        Corrected parser of package version
    </li>
    <li>
        Opening file diffs in a separate window
    </li>
</ul>

<br/>

<b>Version 1.4 (October 25, 2012)</b><br/>
<b>New Features</b>
<ul>
    <li>
        Sorting by status, delta and file name in the report
    </li>
    <li>
        New -open option to open report in the default browser
    </li>
    <li>
        Printing of estimated change rate to the console
    </li>
    <li>
        Simplified usage: pkgdiff PKG1 PKG2
    </li>
    <li>
        Support for Mac OS X
    </li>
    <li>
        Support for more file formats
    </li>
</ul>

    <div class="footer">
      get the source code on GitHub : <a href="https://github.com/lvc/pkgdiff">lvc/pkgdiff</a>
    </div>
    <div style="height:350px;"></div>

  </div>
</body>
</html>
